home *** CD-ROM | disk | FTP | other *** search
/ Power Programmierung 2 / Power-Programmierung CD 2 (Tewi)(1994).iso / gnu / gnulib / rcs4 / doc / rlog.man < prev   
Encoding:
Text File  |  1990-08-18  |  5.3 KB  |  199 lines
  1.  
  2.  
  3.  
  4.      RLOG(1L)             Purdue University              RLOG(1L)
  5.  
  6.  
  7.  
  8.      NAME
  9.       rlog - print log messages and    other information about    RCS
  10.       files
  11.  
  12.      SYNOPSIS
  13.       rlog [ options ] file    ...
  14.  
  15.      DESCRIPTION
  16.       Rlog prints information about    RCS files.  Files ending in
  17.       `,v' are RCS files, all others are working files. If a
  18.       working file is given, rlog tries to find the    corresponding
  19.       RCS file first in directory ./RCS and    then in    the current
  20.       directory, as    explained in co(1L).
  21.  
  22.       Rlog prints the following information    for each RCS file: RCS
  23.       file name, working file name,    head (i.e., the    number of the
  24.       latest revision on the trunk), default branch, access    list,
  25.       locks, symbolic names, suffix, total number of revisions,
  26.       number of revisions selected for printing, and descriptive
  27.       text.    This is    followed by entries for    the selected revisions
  28.       in reverse chronological order for each branch. For each
  29.       revision, rlog prints    revision number, author, date/time,
  30.       state, number    of lines added/deleted (with respect to    the
  31.       previous revision), locker of    the revision (if any), and log
  32.       message.  Without options, rlog prints complete information.
  33.       The options below restrict this output.
  34.  
  35.       -L        ignores RCS    files that have    no locks set;
  36.             convenient in combination with -R, -h, or -l.
  37.  
  38.       -R        only prints    the name of the    RCS file; convenient
  39.             for    translating a working file name    into an    RCS
  40.             file name.
  41.  
  42.       -h        prints only    RCS file name, working file name,
  43.             head, default branch, access list, locks, symbolic
  44.             names, and suffix.
  45.  
  46.       -t        prints the same as -h, plus    the descriptive    text.
  47.  
  48.       -b        prints information about the revisions on the
  49.             default branch (normally the highest branch    on the
  50.             trunk).
  51.  
  52.       -ddates   prints information about revisions with a checkin
  53.             date/time in the ranges given by the semicolon-
  54.             separated list of dates.  A    range of the form
  55.             d1<d2 or d2>d1 selects the revisions that were
  56.             deposited between d1 and d2, (inclusive).  A range
  57.             of the form    <d or d> selects all revisions dated d
  58.             or earlier.     A range of the    form d<    or >d selects
  59.             all    revisions dated    d or later.  A range of    the
  60.  
  61.  
  62.  
  63.      Page 1                         (printed 8/18/90)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      RLOG(1L)             Purdue University              RLOG(1L)
  71.  
  72.  
  73.  
  74.             form d selects the single, latest revision dated d
  75.             or earlier.     The date/time strings d, d1, and d2
  76.             are    in the free format explained in    co(1L).
  77.             Quoting is normally    necessary, especially for <
  78.             and    >. Note    that the separator is a    semicolon.
  79.  
  80.       -l[lockers]
  81.             prints information about locked revisions.    If the
  82.             comma-separated list lockers of login names    is
  83.             given, only    the revisions locked by    the given
  84.             login names    are printed.  If the list is omitted,
  85.             all    locked revisions are printed.
  86.  
  87.       -rrevisions
  88.             prints information about revisions given in    the
  89.             comma-separated list revisions of revisions    and
  90.             ranges. A range rev1-rev2 means revisions rev1 to
  91.             rev2 on the    same branch, -rev means    revisions from
  92.             the    beginning of the branch    up to and including
  93.             rev, and rev- means    revisions starting with    rev to
  94.             the    end of the branch containing rev. An argument
  95.             that is a branch means all revisions on that
  96.             branch. A range of branches    means all revisions on
  97.             the    branches in that range.
  98.  
  99.       -sstates  prints information about revisions whose state
  100.             attributes match one of the    states given in    the
  101.             comma-separated list states.
  102.  
  103.       -w[logins]
  104.             prints information about revisions checked in by
  105.             users with login names appearing in    the comma-
  106.             separated list logins.  If logins is omitted, the
  107.             user's login is assumed.
  108.  
  109.       Rlog prints the intersection of the revisions    selected with
  110.       the options -d, -l, -s, -w, intersected with the union of
  111.       the revisions    selected by -b and -r.
  112.  
  113.      EXAMPLES
  114.           rlog    -L  -R    RCS/*,v
  115.           rlog    -L  -h    RCS/*,v
  116.           rlog    -L  -l    RCS/*,v
  117.           rlog    RCS/*,v
  118.  
  119.       The first command prints the names of    all RCS    files in the
  120.       subdirectory `RCS' which have    locks. The second command
  121.       prints the headers of    those files, and the third prints the
  122.       headers plus the log messages    of the locked revisions.  The
  123.       last command prints complete information.
  124.  
  125.      DIAGNOSTICS
  126.  
  127.  
  128.  
  129.      Page 2                         (printed 8/18/90)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      RLOG(1L)             Purdue University              RLOG(1L)
  137.  
  138.  
  139.  
  140.       The exit status always refers    to the last RCS    file operated
  141.       upon,    and is 0 if the    operation was successful, 1 otherwise.
  142.  
  143.      IDENTIFICATION
  144.       Author: Walter F. Tichy, Purdue University, West Lafayette,
  145.       IN, 47907.
  146.       Revision Number: 1.3 ; Release Date: 89/05/02    .
  147.       Copyright c 1982, 1988, 1989 by Walter F. Tichy.
  148.  
  149.      SEE ALSO
  150.       ci(1L), co(1L), ident(1L), rcs(1L), rcsdiff(1L),
  151.       rcsintro(1L),    rcsmerge(1L), rcsfile(5L)
  152.       Walter F. Tichy, "Design, Implementation, and    Evaluation of
  153.       a Revision Control System," in Proceedings of    the 6th
  154.       International    Conference on Software Engineering, IEEE,
  155.       Tokyo, Sept. 1982.
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.      Page 3                         (printed 8/18/90)
  196.  
  197.  
  198.  
  199.